home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / stblank.arc / STBLANK.TXT < prev   
Text File  |  1988-08-08  |  5KB  |  138 lines
  1. ST Blank - The Monitor Blanker : Version 1.1.0
  2. ==============================================
  3.  
  4. (C) Copyright 1989,1990 Mathew Lodge. This program is NOT public domain, but 
  5. you are free to copy it as long as this text file accompanies the executable 
  6. program and resource file. This program may not be sold, but PD libraries are 
  7. free to charge a *reasonable* fee to cover costs.
  8.  
  9. Abstract
  10. ========
  11.  
  12. ST Blank is a small desk accessory which will blank your monitor screen after a 
  13. user definable time of inactivity.
  14.  
  15. Use
  16. ===
  17.  
  18. Selecting the ST Blank item from the desk menu allows you to set the delay 
  19. before blanking in minutes and seconds (default four minutes). Blanking occurs 
  20. when the ST has been inactive for this user definable amount of time. The 
  21. program defines activity as mouse movement or key presses (but not mouse 
  22. clicks). You can also make the screen blank immediately from this dialogue, and 
  23. turn blanking off. Underneath the "Star Display Options" you can say whether 
  24. you want a star-trek type display when the screen is blanked (see below). The 
  25. speed of the star display is also configurable - the higher the speed number, 
  26. the slower the star display (defualt is 29).
  27.  
  28. While the screen is blanked, you get a display of stars similar to that used 
  29. in innumerable space games, as if travelling through space. (This idea is 
  30. shamelessly blagged from the Macintosh screen saver "Stars!" at the request of 
  31. Steve Cassidy). The speed of the star display is configurable (see above). To 
  32. restore the screen and continue, simply move the mouse or press a key.
  33.  
  34. This accessory works in ALL screen resoltions currently supported by the 
  35. standard ST architecture (i.e. Low, medium and high res., but it won't work 
  36. with Mega Screens or with the new screen modes of the TT). The program *should* 
  37. now work on the TT (as of version 1.1.0), when it is in the standard ST screen 
  38. modes. How I wish I had a TT to test the program! Behaviour is likely to be 
  39. unpredictable in the new screen modes.
  40.  
  41. If any errors occur during initialisation (such as out of memory or no resource 
  42. file), then you won't get the ST Blank title on the Desk menu, but the 
  43. accessory won't crash your machine. It will, however, take up memory space (how 
  44. much depends on exactly where initialisation failed).
  45.  
  46.  
  47. Known Problems
  48. ==============
  49.  
  50. TEMPUS and TEMPUS2 : When normal operation is resumed after screen blanking, 
  51. Tempus' on-screen clock will increment wildly and finally settle at the wrong 
  52. time. This is a bug in Tempus, not ST Blank. In Tempus 2, you can avoid this by 
  53. using Tempus' own screen blanking feature instead of ST-Blank. You'll have to 
  54. forgo the star display though...
  55.  
  56.  
  57. Technical Info.
  58. ===============
  59.  
  60. The program attempts not to blank the screen in the middle of disk access, 
  61. but since there's no foolproof way of checking (even looking at flock at $43E 
  62. doesn't work all of the time), this can happen. During testing this didn't 
  63. cause any problems, but this cannot be guaranteed. If anyone knows a foolproof 
  64. method of testing for ongoing floppy/hard disc access, then please let me know.
  65.  
  66. This program installs three of its own interrupt handlers:
  67.  
  68. 1) The mouse movement vector (see XBIOS 34, Kdbvbase, MOUSEVEC vector)
  69.  
  70. 2) MFP level 5 interrupt, Timer C
  71.  
  72. 3) One slot in the VBL queue.
  73.  
  74. All the handlers use the XBRA protocol, and execute the "old" interrupt handler 
  75. when they have done their stuff (which doesn't take long on any of the 
  76. interrupts). I have also attempted to make the whole program "well behaved".
  77.  
  78. This program was written in 68000 Assembly code, using the Metacomco Macro 
  79. Assembler suite, Version 12.00. The resource was constructed using Kuma's 
  80. K-Resource 2.
  81.  
  82.  
  83. Memory Usage
  84. ============
  85.  
  86. Usage                          Bytes
  87. ====================================
  88. Main Program code               3756
  89. (including 400 byte stack)
  90. GEM library code                3072 (!!! - Thank Metacomco for that!)
  91. Resource                        1364
  92. ------------------------------------
  93. Total                           8192
  94.  
  95. Overheads:
  96. ====================================
  97. Screen and palette buffer      32020
  98. Basepage                         256
  99. ------------------------------------
  100. Total                          32276
  101.  
  102. ====================================
  103. Total memory used              40468
  104. ====================================
  105.  
  106.  
  107. Version Changes
  108. ===============
  109.  
  110. Version 1.0.1
  111.         Mainly code changes to improve application compatibility.
  112.  
  113. Version 1.0.2
  114.         Own point plotting routines instead of using A-Line, and a vastly 
  115.         enlarged stack which improved application compatibilty remarkably.
  116.  
  117. Version 1.1.0
  118.         The speed of the star display is now configurable, and the full version 
  119.         number is now displayed on the accessory's menu slot. Also, changes 
  120.         were made to internal data structures so that the program will run on 
  121.         STs with a full 32-bit address bus (i.e. the TT).
  122.  
  123.  
  124. Any comments or requests for improvements to:
  125.  
  126. Mathew Lodge
  127. "Maen Melin"
  128. Holmes Chapel Road
  129. Lach Dennis
  130. Northwich
  131. Cheshire
  132. CW9 7SZ
  133.  
  134. JANET: SOCS18@uk.ac.york.vaxa
  135.  
  136. 23rd February, 1990
  137.  
  138.